home *** CD-ROM | disk | FTP | other *** search
/ Gekikoh Dennoh Club 2 / Gekikoh Dennoh Club Vol. 2 (Japan).7z / Gekikoh Dennoh Club Vol. 2 (Japan) (Track 01).bin / tools / psmed / psmed.doc next >
Text File  |  1997-09-04  |  11KB  |  324 lines
  1. ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
  2. ┃Ｘ６８０ｘ０ Human68k                                       ┃
  3. ┃  ＰＳＭ汎用編集ツール PSMED Ver0.1                         ┃
  4. ┃                                         by ＢＬＡＣＫ．    ┃
  5. ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
  6.  
  7. ┌───────┐
  8. │このツールは？│
  9. └───────┘
  10. ＰＳＭファイルでエディタを作る時に有る程度簡単に作成するために
  11. 作られた汎用ＰＳＭエディタです。
  12.  
  13. ＰＳＭファイルとはＰＳＭＥＭで作られるＰＳメモリーカードデータファイルです。
  14. ＰＳＭＥＭや拙作ＳＸＰＳＭＥＭなどを持ってない人は無用の長物になってしまいます。
  15. ただし、他のＰＳメモリーカードツールには数種類有り、
  16. それらのデータファイル相互コンバータも存在するようです。
  17.  
  18. ＳＸ－ＷＩＮＤＯＷのコンソールウィンドウでも動作可能にするために
  19. 画面構成、入力はコンソールとＤＯＳコールを用いて作られています。
  20.  
  21. ┌───┐
  22. │使い方│
  23. └───┘
  24. コマンドに編集情報ファイルとＰＳＭファイルを渡します。
  25. psmed [option] <*.ped> <*.psm>
  26. となっています。
  27. オプションには
  28.  -b バックアップファイルを作成しない。（編集情報に指定がない場合も有効）
  29.  -v ビューモード。書き込み禁止。
  30. が有ります。
  31.  
  32. 編集情報ファイルの方は拡張子が省略出来ます。
  33. また、そのパスで見つからなかった場合、
  34. 実行ファイルが格納されているパスも探しに行きます。
  35.  
  36. ┌────┐
  37. │画面操作│
  38. └────┘
  39. エディタ画面は以下のキー操作で使えます。
  40. ROLL UP        次ページへ
  41. ROLL DOWN    前ページへ
  42. ↑        カーソルを上げます。
  43. ↓        カーソルを下げます。
  44. RET        項目データの入力（または選択）に移ります。
  45. ESC        ＰＳＭＥＤを終了します。
  46. V        書き込み禁止にする。
  47.  
  48. 項目データ入力時は何も入れないでリターンすると内容を更新しません。
  49. History.xに対応しているので使い易くなっていると思います。
  50. ＰＳＭＥＤ実行中はＣＬＲキーの定義をＶＯＩＤに変えていますので
  51. 入力内容消去にＣＬＲキーが使えます。
  52. ただし、History.x登録時のVOIDになっているESC･Eを登録するので
  53. History.xが組み込まれて無い時は無効かもしれません。
  54.  
  55. 書き込み禁止化はその時点で禁止するので変更後に禁止しても
  56. 項目値は現状維持のままになります。
  57. さらにファイル出力も行われないため同時に今までの変更も
  58. ファイルに対して無効になります。
  59.  
  60. メニューで選択時も同様な操作になります。
  61. ROLL UP        次ページへ
  62. ROLL DOWN    前ページへ
  63. ↑        カーソルを上げます。
  64. ↓        カーソルを下げます。
  65. RET        決定
  66. ESC        選択中断
  67.  
  68. ┌──────────┐
  69. │編集情報定義ファイル│
  70. └──────────┘
  71. 詳しくは付属のサンプルが参考になると思います。
  72. 拡張子はＰＥＤと決まっています。
  73. 普通のテキストファイルですのでエディタで作成出来ます。
  74. １コマンド１行で構成され、コマンドに対して幾つかのオプションが付く格好になります。
  75.  
  76. 先頭行には以下の認識ＩＤが必要ですので忘れない様にして下さい。
  77. *** PSMED Edit information file Ver.1 ***
  78.  
  79. コメントは先頭文字が '*','#',';','/'のいずれかでコメント行になります。
  80. 空行は無視されます。
  81. コマンドは以下の通りです。（コマンドは大文字小文字を同一視します）
  82.  
  83. id        対象ＰＳＭのＩＤ
  84. option        オプションスイッチ
  85. pagetitle    ページのタイトル
  86. title        ページ内タイトル
  87. edit.b        バイト編集
  88. edit.w        ワード編集
  89. edit.l        ロングワード編集
  90. edit.s        文字列編集
  91. page        次ページへ
  92. menu        メニュー使用設定
  93. menuitem    メニュー項目設定
  94. menu.b        バイトメニュー編集
  95. menu.w        ワードメニュー編集
  96. menu.l        ロングワードメニュー編集
  97. checksum.p    チェックサム補正プログラムの設定
  98. end        終了
  99.  
  100. コマンドとオプション間は、" \t\n,:="をキーに区切るので
  101. 実はサンプルで使っている表記以上に有る程度柔軟に書けます。
  102. 最後の項目名やタイトルは "\n\t"をキーにしています。
  103. 例外があるかもしれませんがコマンドの行末でタブに続けて書くと
  104. コメントとして使用出来る場合があります。
  105. コマンドの解釈次第ですが必要以上にコマンドの引数が多いとそれらは無視されます。
  106.  
  107. メニューを定義することでメニュー選択項目を作る事が可能です。
  108. アイテムなど数値よりも名前の選択にしたい時に有効です。
  109.  
  110. 画面は１ページ２５項目となっています。
  111. 編集項目（とタイトル）を入れる度に１項目消費し、
  112. ページから外れた分は次ページへと回されていきます。
  113. ページ内にタイトルを入れたり、（titleコマンド）
  114. 改ページさせる（pageコマンド）事も出来るようにしています。
  115.  
  116. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  117. ・ＩＤ
  118.  
  119. ID    <ＩＤ文字列>
  120.  
  121. 編集情報が対応するＰＳＭファイルの指定になります。
  122. 必ず指定する必要があります。
  123. このＩＤはＰＳＭファイル先頭１２バイト目から入っている物です。
  124. これはＰＳが管理する本当のファイル名です。
  125. ＰＳＭファイル側とは先頭一致で判定するので同一部分まで書いて下さい。
  126. 複数セーブ出来る物はセーブ番号で末端を変えたりしています。
  127.  
  128. SLPS-1234A セーブ１
  129. SLPS-1234B セーブ２
  130. SLPS-1234C セーブ３
  131. SLPS-1234D セーブ４
  132.  
  133. この場合は
  134.  
  135. ID    SLPS-1234
  136.  
  137. としておけば全部判定が通ります。
  138. ただし、これとて完全ではなくゲームのファイル名の付け方によっては
  139. 通して欲しくないファイルまで通ることがあるので注意して下さい。
  140. 上の場合にさらに、
  141.  
  142. SLPS-1234X システムデータ
  143.  
  144. なんてあったりすると形式が違うであろうシステムデータも通ってしまいます。
  145. とりあえず今はゲームの種類を間違えない程度です。
  146.  
  147. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  148. ・ＯＰＴＩＯＮ
  149.  
  150. OPTION    <オプション文字列>
  151.  
  152. この編集情報固有のオプションスイッチです。
  153. コマンドオプションとは違います。
  154. オプションの文字列に文字を並べることによって指定します。
  155. 現在は以下の通りです。
  156.  
  157. a    アドレスはＰＳＭファイルのオフセット
  158. b    バックアップを作成しない
  159. v    閲覧のみとする
  160.  
  161. 全部指定する時は
  162.  
  163. option    abv
  164.  
  165. となります。
  166. 大文字小文字を区別するので注意して下さい。
  167. 該当しない文字は無視されます。
  168.  
  169. アドレスはＰＳＭファイルとすると、
  170. ＰＳＭファイルをダンプした場合のアドレスがそのまま使えます。
  171. 指定無しの場合は純粋にブロックデータを順番に個数分並べた場合のアドレスになります。
  172. 使っている人にはＰＳＭＥＤＩＴと同じといえば解り易いと思います。
  173. ＰＳＭファイルはその形式上ブロックデータのアドレスが一致しないので
  174. 内部にアドレス変換機能を付けてあります。
  175. ＦＥＳで見る場合が多い人は指定した方が混乱が無いでしょう。
  176.  
  177. 閲覧のみとするとライトプロテクト状態となります。
  178. 編集用の情報ではない時に指定するといいでしょう。
  179.  
  180. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  181. ・ＰＡＧＥＴＩＴＬＥ
  182.  
  183. PAGETITLE    <タイトル文字列>
  184.  
  185. そのページのタイトルです。
  186. ページの内容を示します。無指定時には何も出ません。
  187. ページの項目数には影響を与えません。
  188. 専用の表示場所を取っています。
  189.  
  190. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  191. ・ＴＩＴＬＥ
  192.  
  193. TITLE    <タイトル文字列>
  194.  
  195. ページ内に自由に置ける項目タイトルです。
  196. ページ内で区切りたい時などに使えます。
  197. データ編集コマンド同様１項目消費します。
  198.  
  199. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  200. ・ＥＤＩＴ．Ｂ
  201. ・ＥＤＩＴ．Ｗ
  202. ・ＥＤＩＴ．Ｌ
  203.  
  204. EDIT.B    <アドレス>    <項目名>
  205. EDIT.W    <アドレス>    <項目名>
  206. EDIT.L    <アドレス>    <項目名>
  207.  
  208. データ編集コマンドです。
  209. ページ内容の編集項目の定義に当たります。
  210. .b .w .lの違いはそれぞれバイト、ワード、ロングワードサイズです。
  211. 内容表示は１０進符号無しになっています。
  212. アドレスはＣ言語表記が使えます。また、＄による１６進表記も使えます。
  213. アドレスを指定する時はくれぐれもデータはリトルエンディアン(*1)で
  214. 格納されている事を忘れないで下さい。
  215. 指定するアドレスは格納開始アドレスですのでバイト順の
  216. 一番左側のアドレスになります。
  217. ＰＳのＣＰＵはリトルエンディアンで動作していると思われます。
  218. 今のところわざわざひっくり返して格納していたのは見た事はありません。
  219. 一応・・・
  220.  
  221. *1 リトルエンディアン
  222. 要するに２５６とあったら普通はメモリー上に格納されるのは 01 00 ですが、
  223. リトルエンディアンでは 00 01 と収まる事を意味します。
  224. ロングワードでも 16909060 は 01 02 03 04 ではなく 04 03 02 01 となります。
  225. バイト順が鏡に映したように全く正反対になります。
  226. ６８系のように素直に格納されるのはビッグエンディアンです。
  227.  
  228. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  229. ・ＥＤＩＴ．Ｓ
  230.  
  231. EDIT.S    <アドレス>,<サイズ>    <項目名>
  232.  
  233. 文字列データ編集コマンドです。
  234. これもページ内容の編集部分の定義に当たります。
  235. サイズは占める容量を指定して下さい。
  236. 文字列は０終端で有るという前提が有りますのでその分もサイズに入れて下さい。
  237. 容量に満たない文字列の後は０で埋められますが、
  238. 入力可能な文字列長はサイズ－１バイトまでです。
  239. 今のところ０終端でない文字列は考慮に有りません。
  240. アドレスとサイズはＣ言語表記が使えます。また、＄による１６進表記も使えます。
  241.  
  242. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  243. ・ＰＡＧＥ
  244.  
  245. PAGE
  246.  
  247. ページ送りコマンドです。
  248. ページの内容をここで打ち止めにする場合に使用します。
  249. 通常は１ページ２５項目で自動的にページ送りされます。
  250.  
  251. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  252. ・ＭＥＮＵ
  253.  
  254. MENU    <メニュー項目数の並び>
  255.  
  256. 一覧で選択するメニューの定義をします。メニューは最大８つまで定義出来ます。
  257. 項目数が１０個のメニューを２つ用意する場合は、
  258.  
  259. MENU    10,10
  260.  
  261. と、なります。
  262. 個数が満たない場合は残りは０個として扱います。
  263. このコマンドを使わない限りメニュー関係のコマンドはエラーになります。
  264. 一時的な打ち消し用に０個も指定出来るようにはしてあります。
  265. メニューは定義しておきたいが実際の選択は禁止しておきたい場合に使って下さい。
  266.  
  267. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  268. ・ＭＥＮＵＩＴＥＭ
  269.  
  270. MENUITEM    <メニュー番号>,<項目番号>    <項目名>
  271.  
  272. メニューの項目内容を定義します。１回１項目の定義となります。
  273. メニュー番号は１～定義した個数までです。
  274. 項目番号は０～項目数－１までです。
  275. メニュー毎にそれぞれ最大項目数分まで使用出来ます。
  276. 最後に渡って指定されてない項目番号がある場合はメニュー選択に出てきません。
  277. 従って判明している分から登録していく事が可能です。
  278. この項目番号が実際のデータに対応します。
  279. 逆に言えばデータ値に名前を付けていく事になります。
  280.  
  281. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  282. ・ＭＥＮＵ．Ｂ
  283. ・ＭＥＮＵ．Ｗ
  284. ・ＭＥＮＵ．Ｌ
  285.  
  286. MENU.B    <アドレス>,<メニュー番号>    <項目名>
  287. MENU.W    <アドレス>,<メニュー番号>    <項目名>
  288. MENU.L    <アドレス>,<メニュー番号>    <項目名>
  289.  
  290. メニューによるデータ編集コマンドです。
  291. .b .w .lの違いはそれぞれバイト、ワード、ロングワードサイズです。
  292. 内容表示はそのデータから項目名をメニュー内容から取り出して表示します。
  293. 編集時は項目名一覧で選択することになります。
  294. メニュー番号は１～定義した個数までです。
  295.  
  296. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  297. ・ＣＨＥＣＫＳＵＭ．Ｐ
  298.  
  299. CHECKSUM.P    <コマンド文字列>
  300.  
  301. 編集後に実行させるチェックサム補正プログラムを設定します。
  302. たいていのセーブデータには、メモリーカード故障など万一の為に
  303. データ化けを検査するチェックサムを取っているのが普通です。
  304. そのチェックサム補正が出来れば編集してもデータ化けと認識させない事が出来ます。
  305. その補正をするプログラムを指定して下さい。
  306. チェックサムの計算方法は何等かの方法で調べるしかありません。
  307. 計算方法を直接定義することは出来ません。別個にプログラムを作って下さい。
  308.  
  309. コマンド文字列内に %f をオプションで入れると編集したファイル名に置換します。
  310. 書き込み禁止の場合はもちろん実行されません。
  311.  
  312. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  313. ・ＥＮＤ
  314.  
  315. END
  316.  
  317. 終了コマンドです。
  318. 編集情報の解釈を終了します。
  319. ＥＮＤコマンドを入れた後にドキュメントを付けたり、
  320. 何かの理由で解釈を中断させたい時などに使えます。
  321.  
  322. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  323.  
  324.